###1. Overview This document describes the "Airplane" DocType, a data structure used to store information about airplanes within the "Clearing" module.
###2.Purpose:
The "Airplane" DocType is designed to manage and organize data related to airplanes, including their identification, specifications, and associated airline information. This data can be utilized for various purposes, such as tracking aircraft inventory, scheduling flights, and managing maintenance records.
###3.Fields:
The "Airplane" DocType consists of the following fields:
| Field Name | Description |
|---|---|
name1 |
A unique name or identifier for the airplane. |
airline |
A link to the "Airline" DocType, representing the airline that owns or operates the airplane. This field establishes a relationship between airplanes and airlines. |
flight_number |
The unique flight number assigned to the airplane. This field is used for identifying specific flights and is automatically used as the record's name. |
aircraft_type |
The type of aircraft, selected from a predefined list. Options include "Passenger," "Cargo," and "Private." This field categorizes the airplane based on its primary function. |
capacity |
The capacity of the airplane, which can represent the number of seats for passenger planes or the cargo capacity for cargo planes. |
registration_number |
The unique registration number of the airplane, often used for official identification and tracking. |
year_built |
The year the airplane was manufactured. |
###4. Step-by-Step Usage
4.1 Creating a New Airplane Record:
Navigate to the "Airplane" list. This can typically be found under the "Clearing" module or through the global search bar.
Click on the "New" button to open a blank "Airplane" form. Name: The "Name" field will be automatically populated based on the "Flight Number" once you enter it. You can manually edit it if required, but ensure it remains unique.
Airline: Click on the dropdown arrow in the "Airline" field and select the airline operating this airplane from the list of existing "Airline" records.
Aircraft Type: Choose the appropriate type of aircraft (Passenger, Cargo, or Private) from the "Aircraft Type" dropdown menu.
Flight Number: Enter the unique flight number of the airplane in the "Flight Number" field. This field is mandatory and must be unique across all airplane records.
Capacity (Seats/Cargo): Enter the capacity of the airplane. This could be the number of passenger seats or a description of the cargo capacity (e.g., volume, weight limit).
Registration Number: Enter the official registration number of the airplane.
Year Built: Enter the year the airplane was manufactured as an integer (e.g., 2022).
Click on the "Save" button to create the new airplane record.
###5. Troubleshooting (Common Errors and Resolutions)
Error: "Name must be unique": This error occurs when you try to save an airplane record with a "Name" that already exists in the system. Ensure the "Name" field is unique. The system automatically suggests the "Flight Number" as the name, which should generally resolve this.
Error: "Flight Number must be unique": This error occurs when you try to save an airplane record with a "Flight Number" that already exists. Verify the flight number you are entering is correct and unique.
Error: "Invalid Link: Airline [XYZ] does not exist": This error appears if you try to link an airplane to an "Airline" that has not been created in the "Airline" doctype. Ensure the relevant airline record exists before linking.
Unable to Save Record: If you are unable to save the record, check if all mandatory fields (if any are configured) are filled correctly and if there are any validation errors displayed.
Permission Denied: If you are unable to perform certain actions (e.g., create, edit, delete), it indicates that your user role does not have the necessary permissions for that operation. Contact your system administrator to review your user role and permissions.
If you encounter other errors or issues, please consult the system's error logs or contact your system administrator for assistance.
###6. Key Notes
Maintain accurate and up-to-date information for all airplane records.
Ensure that "Airline" records are created before linking them to airplane records.
Be cautious when deleting airplane records as this action is irreversible.
If you require specific customizations or integrations, consult with your system administrator or development team.
Refer to other relevant module manuals for information on related doctypes like "Airline."
###6. What business process pain point does it help remove
The "Airplane" doctype helps remove several business process pain points, including:
Disorganized Data Management: Eliminates the need for scattered spreadsheets or paper-based records for managing airplane information, centralizing all relevant data in a structured and easily accessible system.
Inefficient Information Retrieval: Makes it quick and easy to find specific airplane details using search and filtering options, saving time and effort compared to manually searching through documents.
Lack of Data Consistency: Enforces data integrity through field types, unique constraints (for Name and Flight Number), and potential custom validations, reducing errors and ensuring consistent information across all records.
Difficulty in Reporting and Analysis: Provides a structured dataset that can be used for generating reports on the airplane fleet, such as the number of airplanes per airline, distribution of aircraft types, or average fleet age.
Poor Collaboration and Communication: Offers a shared platform for authorized users to access and update airplane information, improving collaboration and reducing the risk of outdated or conflicting data.
Manual Tracking of Key Information: Automates the tracking of essential airplane details like capacity, registration, and year built, reducing the manual effort required to maintain this information.
Challenges in Regulatory Compliance: By maintaining accurate records of registration numbers and other relevant details, the system can aid in meeting regulatory requirements.
By addressing these pain points, the "Airplane" doctype contributes to more efficient, accurate, and informed decision-making in managing an airplane fleet.